<!DOCTYPE html>
<!-- Generated by pkgdown: do not edit by hand --><html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><title>Ratios at each site, of avg dist of group / avg dist of everyone else near site — distance_by_group_by_site • EJAM</title><!-- favicons --><link rel="icon" type="image/png" sizes="16x16" href="../favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="../favicon-32x32.png"><link rel="apple-touch-icon" type="image/png" sizes="180x180" href="../apple-touch-icon.png"><link rel="apple-touch-icon" type="image/png" sizes="120x120" href="../apple-touch-icon-120x120.png"><link rel="apple-touch-icon" type="image/png" sizes="76x76" href="../apple-touch-icon-76x76.png"><link rel="apple-touch-icon" type="image/png" sizes="60x60" href="../apple-touch-icon-60x60.png"><script src="../deps/jquery-3.6.0/jquery-3.6.0.min.js"></script><meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"><link href="../deps/bootstrap-5.3.1/bootstrap.min.css" rel="stylesheet"><script src="../deps/bootstrap-5.3.1/bootstrap.bundle.min.js"></script><link href="../deps/font-awesome-6.4.2/css/all.min.css" rel="stylesheet"><link href="../deps/font-awesome-6.4.2/css/v4-shims.min.css" rel="stylesheet"><script src="../deps/headroom-0.11.0/headroom.min.js"></script><script src="../deps/headroom-0.11.0/jQuery.headroom.min.js"></script><script src="../deps/bootstrap-toc-1.0.1/bootstrap-toc.min.js"></script><script src="../deps/clipboard.js-2.0.11/clipboard.min.js"></script><script src="../deps/search-1.0.0/autocomplete.jquery.min.js"></script><script src="../deps/search-1.0.0/fuse.min.js"></script><script src="../deps/search-1.0.0/mark.min.js"></script><!-- pkgdown --><script src="../pkgdown.js"></script><meta property="og:title" content="Ratios at each site, of avg dist of group / avg dist of everyone else near site — distance_by_group_by_site"><meta name="description" content="Like distance_by_group() but for multiple sites - DRAFT FUNCTION"><meta property="og:description" content="Like distance_by_group() but for multiple sites - DRAFT FUNCTION"><meta property="og:image" content="https://usepa.github.io/EJAM/logo.svg"></head><body>
    <a href="#main" class="visually-hidden-focusable">Skip to contents</a>


    <nav class="navbar navbar-expand-lg fixed-top bg-light" data-bs-theme="light" aria-label="Site navigation"><div class="container">

    <a class="navbar-brand me-2" href="../index.html">EJAM</a>

    <small class="nav-text text-warning me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Released version">2.32.0</small>


    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>

    <div id="navbar" class="collapse navbar-collapse ms-3">
      <ul class="navbar-nav me-auto"><li class="active nav-item"><a class="nav-link" href="../reference/index.html">Reference</a></li>
<li class="nav-item dropdown">
  <button class="nav-link dropdown-toggle" type="button" id="dropdown-articles" data-bs-toggle="dropdown" aria-expanded="false" aria-haspopup="true">Articles</button>
  <ul class="dropdown-menu" aria-labelledby="dropdown-articles"><li><hr class="dropdown-divider"></li>
    <li><h6 class="dropdown-header" data-toc-skip>Overview for EJAM Users</h6></li>
    <li><a class="dropdown-item" href="../articles/0_whatis.html">What is EJAM</a></li>
    <li><a class="dropdown-item" href="../articles/0_webapp.html">Using EJAM</a></li>
    <li><hr class="dropdown-divider"></li>
    <li><h6 class="dropdown-header" data-toc-skip>For analysts using R</h6></li>
    <li><a class="dropdown-item" href="../articles/1_installing.html">Installing the EJAM R package</a></li>
    <li><a class="dropdown-item" href="../articles/2_quickstart.html">Quick Start Guide</a></li>
    <li><a class="dropdown-item" href="../articles/3_analyzing.html">Basics of Using EJAM for Analysis in RStudio</a></li>
    <li><a class="dropdown-item" href="../articles/4_advanced.html">Advanced Features</a></li>
  </ul></li>
<li class="nav-item"><a class="nav-link" href="../news/index.html">Changelog</a></li>
      </ul><ul class="navbar-nav"><li class="nav-item"><form class="form-inline" role="search">
 <input class="form-control" type="search" name="search-input" id="search-input" autocomplete="off" aria-label="Search site" placeholder="Search for" data-search-index="../search.json"></form></li>
<li class="nav-item"><a class="external-link nav-link" href="https://github.com/USEPA/EJAM/" aria-label="GitHub"><span class="fa fab fa-github fa-lg"></span></a></li>
      </ul></div>


  </div>
</nav><div class="container template-reference-topic">
<div class="row">
  <main id="main" class="col-md-9"><div class="page-header">
      <img src="../logo.svg" class="logo" alt=""><h1>Ratios at each site, of avg dist of group / avg dist of everyone else near site</h1>
      <small class="dont-index">Source: <a href="https://github.com/USEPA/EJAM/blob/HEAD/R/distance_by_groups_by_site-DRAFT.R" class="external-link"><code>R/distance_by_groups_by_site-DRAFT.R</code></a></small>
      <div class="d-none name"><code>distance_by_group_by_site.Rd</code></div>
    </div>

    <div class="ref-description section level2">
    <p>Like <code>distance_by_group()</code> but for multiple sites - DRAFT FUNCTION</p>
    </div>

    <div class="section level2">
    <h2 id="ref-usage">Usage<a class="anchor" aria-label="anchor" href="#ref-usage"></a></h2>
    <div class="sourceCode"><pre class="sourceCode r"><code><span><span class="fu">distance_by_group_by_site</span><span class="op">(</span><span class="va">bybg</span><span class="op">)</span></span></code></pre></div>
    </div>

    <div class="section level2">
    <h2 id="arguments">Arguments<a class="anchor" aria-label="anchor" href="#arguments"></a></h2>


<dl><dt id="arg-bybg">bybg<a class="anchor" aria-label="anchor" href="#arg-bybg"></a></dt>
<dd><p>such as <code><a href="ejamit.html">ejamit()</a></code>$results_bybg_people</p></dd>

</dl></div>
    <div class="section level2">
    <h2 id="value">Value<a class="anchor" aria-label="anchor" href="#value"></a></h2>
    <p>table of ratios, one col per site, one row per indicator</p>
    </div>
    <div class="section level2">
    <h2 id="details">Details<a class="anchor" aria-label="anchor" href="#details"></a></h2>
    <p>There are two aspects of proximity to consider when analyzing
demographic groups within a certain fixed distance (radius) from a single
facility point (or a whole set of facilities). These two ways of summarizing
proximity are complementary:</p><ol><li><p>Which groups tend to live nearby in the sense of being within the selected radius
versus outside the radius? In other words, which groups are "overrepresented"
within X miles of the site? This treats proximity as a yes/no, binomial
question – a resident is nearby or not. It would focus on whether someone is
anywhere within 3 miles, say, and ignore the differences between
being 1, 2, or 3 miles away.</p></li>
<li><p>Among the residents within X miles of the site, which groups live especially close to the
facility? This question recognizes proximity is a continuous variable, and
focuses on the difference between 1 mile, 1.5 miles, etc. However, it only
looks at residents within the X miles radius area analyzed, so it fails
to recognize that some groups tend to live more than 3 miles away, for example.
This perspective does not take into account which groups are overrepresented
within the original total radius near a site.</p></li>
</ol><p>This function does the second of these two types of analysis. It reports,
only among those anywhere inside the radius, which groups are closer to the site.</p>
<p>In a specific location, for example, one demographic group could be
underrepresented within 3 miles, but those few who are in the group
still might live right next to the facility in which case
their average distance would be higher than that of any other group
because this function only counts those within the radius analyzed.</p>
<p>In some other location, the opposite could occur – if one group is
overrepresented within 3 miles, they still might all live in a community
about 2.9 miles away from the site – that would mean their distance from
the site on average is greater (or their proximity score is lower)
than other groups within 3 miles of the site.</p>
    </div>
    <div class="section level2">
    <h2 id="see-also">See also<a class="anchor" aria-label="anchor" href="#see-also"></a></h2>
    <div class="dont-index"><p><code><a href="ejamit_compare_distances.html">ejamit_compare_distances()</a></code> <code><a href="distance_by_group_plot.html">distance_by_group_plot()</a></code> <code><a href="plot_distance_mean_by_group.html">plot_distance_mean_by_group()</a></code> <code>distance_by_group()</code> <code><a href="distance_mean_by_group.html">distance_mean_by_group()</a></code></p></div>
    </div>

    <div class="section level2">
    <h2 id="ref-examples">Examples<a class="anchor" aria-label="anchor" href="#ref-examples"></a></h2>
    <div class="sourceCode"><pre class="sourceCode r"><code><span>  <span class="co"># distance_by_group_by_site(</span></span>
<span>  <span class="co">#   testoutput_ejamit_10pts_1miles$results_bybg_people</span></span>
<span>  <span class="co"># )</span></span>
<span></span></code></pre></div>
    </div>
  </main><aside class="col-md-3"><nav id="toc" aria-label="Table of contents"><h2>On this page</h2>
    </nav></aside></div>


    <footer><div class="pkgdown-footer-left">
  <p>US EPA 2024</p>
</div>

<div class="pkgdown-footer-right">
  <p>EJAM Version 2.32.0</p>
</div>

    </footer></div>





  </body></html>

